# Hero Lane Distribution

> `GET /api/academy/heroes/{hero_identifier}/lane`: Academy endpoint of the Rone Arena API.

Retrieve lane distribution information for a specific hero. Supports query parameters for pagination and localization.

Path parameters:
- **hero_identifier**: Hero identifier as numeric hero ID or hero name. Accepts values like `30`, `Yi Sun-shin`, or `yisunshin`.

Query parameters:
- **size**: Number of items per page (minimum: 1).
- **index**: Page index (starting from 1).
- **lang**: Language code for localized content (default: `en`).

The response includes hero lane distribution data:
- **records**: Array of hero entries, each containing:
    - **data**:
        - **hero_id**: Unique hero identifier.
        - **hero**:
            - **data**:
                - **roadsort**: Array of lane assignments, each containing:
                    - **_id**: Unique record identifier.
                    - **caption**: Localized lane caption (e.g., '打野').
                    - **configId**: Configuration ID.
                    - **createdAt**: Creation timestamp.
                    - **createdUser**: Creator username.
                    - **updatedAt**: Last update timestamp.
                    - **updatedUser**: Last updater username.
                    - **data**:
                        - **road_sort_id**: Lane ID (e.g., '4').
                        - **road_sort_title**: Lane title (e.g., 'Jungle').
                        - **road_sort_icon**: Lane icon URL.

This endpoint is useful for:
- Analyzing hero lane preferences.
- Understanding optimal lane assignments.
- Guiding players in hero positioning strategies.

## Request

`GET https://arena.rone.dev/api/academy/heroes/{hero_identifier}/lane`

### Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `hero_identifier` | path | string | yes |  | Hero identifier as numeric hero ID or hero name. Accepts values like `30`, `Yi Sun-shin`, or `yisunshin`. Name matching ignores spaces/symbols and is case-insensitive (e.g., `Luo Yi` to `luoyi`). |
| `size` | query | integer | no | `20` | Number of items per page. Range: 1... |
| `index` | query | integer | no | `1` | Page index for pagination. Range: 1... |
| `lang` | query | string | no | `en` | Language code for localized content. One of: `en`, `id`, `ru`, `es`, `pt`, `tr`, `ar`, `de`, `fr`, `it`, `ja`, `ko`, `th`, `vi`, `zh-CN`, `zh-TW`, `km`. |

### Example

```bash
curl -X GET 'https://arena.rone.dev/api/academy/heroes/{hero_identifier}/lane'
```

## Example response

```json
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "hero": {
            "data": {
              "roadsort": [
                {
                  "_id": "668541caaa8e7f6ec4703d8a",
                  "caption": "\u6253\u91ce",
                  "configId": 144237,
                  "createdAt": 1720009162509,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2732073,
                    "road_sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fde611167c7310681135f0b4198137bfa.svg",
                    "road_sort_id": "4",
                    "road_sort_title": "Jungle"
                  },
                  "id": 2732080,
                  "linkId": [
                    2732073
                  ],
                  "sort": 0,
                  "updatedAt": 1723022951463,
                  "updatedUser": "nickjin"
                },
                ""
              ]
            }
          },
          "hero_id": 17
        }
      }
    ],
    "total": 1
  }
}
```

## Links

- Try it in the playground: https://arena.rone.dev/web/academy/heroes/{hero_identifier}/lane
- Academy endpoints: https://arena.rone.dev/web/academy.md
- OpenAPI schema: https://arena.rone.dev/api/openapi.json